home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / Tele / Pete Johnson / Log-O-Matic 1.72.sit / About Log-O-Matic… < prev    next >
Encoding:
Text File  |  1990-11-22  |  10.4 KB  |  244 lines  |  [TEXT/QED1]
  1.                             About Log-O-Matic…
  2.  
  3. Log-O-Matic is a Host/Tabby NetMail application which can automatically
  4. maintain your UserLog, CallerLog and Tabby Logs. If you wish, you can have
  5. Log-O-Matic do any or all of the following:
  6.  
  7. • Backup the UserLog, optionally marking users at a given level for deletion
  8. and, also optionally, purging users marked for deletion. In addition to
  9. trimming users marked for deletion, this allows you to (for instance)
  10. automatically delete users who have not completed a Validation Survey or who
  11. are inactive.
  12.  
  13. • Sort the UserLog by a combination of level and date of last call (users
  14. are sorted by level, with users in each level category sorted from most
  15. recent call to least recent call).
  16.  
  17. • Zero “Minutes Used in Last Call” for every entry in the UserLog. This
  18. allows everybody to have a fresh start after Log-O-Matic is run.
  19.  
  20. • Maintain a log of deleted users with their most important statistics.
  21.  
  22. • Reset the CallerLog, archiving all entries prior to today’s date in a
  23. file called CallerLog.Arch.
  24.  
  25. • Reset the CallerLog.Arch file on the first of each month, saving the file
  26. contents to a file called CallerLog mm/yy (where mm is a two-digit month
  27. and yy is a two-digit year) and creating a new empty file called
  28. CallerLog.Arch.
  29.  
  30. • Reset the Tabby Log, archiving all entries prior to today’s date in a
  31. file called Tabby Log.Arch.
  32.  
  33. • Limit the size of the Tabby Log.Arch file.
  34.  
  35. With all of its abilities, Log-O-Matic replaces several individual
  36. utilities, including ZeroMin, ArchiveCL, Archive TL and BackUL.
  37.  
  38. Log-O-Matic is a long name. I’ve abbreviated it to LOM in my Tabby events,
  39. and I’ll use that abbreviation sometimes here in the docs, too.
  40.  
  41. --------------------------------------------------------------------------
  42.  
  43. To use Log-O-Matic, place it as an entry in a Tabby NetMail event or, if
  44. you’re not running Tabby, tell Red Ryder Host to run it as a NetMail
  45. application.
  46.  
  47. Once it is set to run, launch Log-O-Matic while holding down the mouse
  48. button. You will see a dialog with a number of options, as follows:
  49.  
  50. Next Launch
  51. -----------
  52. Fill this in with the application Log-O-Matic should launch when it’s
  53. done. Normally, this would be Red Ryder Host.
  54.  
  55. Backup UserLog
  56. --------------
  57. Enable this if you want to back up the UserLog. An unaltered copy of the
  58. UserLog will be saved as UserLog.BAK. Depending on how you configure options,
  59. a copy of the UserLog will be made, with or without deleted users purged. 
  60.  
  61.    >>Delete Level. If this is enabled, you can enter a level which
  62.      qualifies the user for deletion. I use zero on Glassell Park, which
  63.      trims out users who don’t complete my vaildation survey.
  64.  
  65.    >>Check <= [you select]. Sets the range of users who will be processed by
  66.      Log-O-Matic. Users with clearances equal to or less are checked for
  67.      inactivity and possible deletion according to the criteria you set. Users
  68.      with clearances over your selection are not affected.
  69.  
  70.    >>Skip Deletes. If this is enabled, users marked for deletion are
  71.      purged from the working copy of the UserLog. Otherwise they remain as
  72.      entries with the delete flag set. Apart from verifying that LOM works
  73.      correctly, I can’t imagine why someone would not enable this option.
  74.  
  75.    >>Change level. If this is enabled, the user level entered into the
  76.      first edit field is changed to the level in the second field and the
  77.      user’s time is adjusted to the number in the third field. I use this
  78.      to complete my validation process overnight.
  79.  
  80.    >>After [you select] days delete inactive. If this is enabled, users with
  81.      clearances equal to or less than the setting of “Check <=” are
  82.      compared with your setting. If they haven’t called for more
  83.      than that number of days, they are marked deleted. Log-O-Matic comes
  84.      preset to delete level 10 users who haven’t called in 180 days --
  85.      nearly six months. If you don’t want to auto-delete hibernating users,
  86.      don’t enable this. To protect valued inactive users, give them access
  87.      levels higher than the setting of “Check <= nnn”.
  88.  
  89.    >>Log Deletes. If this is enabled, Log-O-Matic will maintain a text file
  90.      called “Users Deleted” at the same level as the UserLog. This file
  91.      lists users deleted by LOM in the following format:
  92.  
  93.            Calls    Last       UL   DL  Pub  Pri  Lev  Min   Reason
  94. DON AMINES from Simi Valley    [DRYDUST]
  95. 11/09/90      17  11/01/90      0   58    0    0   10   30   Unknown
  96. FRED ENTERMAN from FLINT,MI    [MASQUE]
  97. 11/09/90       1  11/09/90      0    0    0    0    0   20   Bad Level
  98. DEATH CRASHER from el monte, ca    [BOOM!]
  99. 11/09/90       1  11/09/90      0    0    0    0    9   20   Bad Name
  100. SCOTT MIXTER from West Los Angeles    [MISTLE]
  101. 11/09/90       4  12/19/88      0   15    0    1   10   30   Inactive
  102.  
  103.      As you can see, each user name is followed the password in brackets, then
  104.      by a line containing date of deletion, number of calls, date of last
  105.      call, uploads, downloads, public and private message counts, level and
  106.      time limit in addition to a reason for the deletion. Possible reasons are
  107.      Inactive, Bad Name, One-Timer, Bad Level and Unknown. The latter reason
  108.      would happen if you delete a user with another utility and then back up
  109.      the UserLog with LOM.
  110.  
  111.    >>One-time call limit zzz days. If this is enabled, Log-O-Matic will
  112.      delete one-time callers after zzz days. As an additional check, LOM
  113.      marks them for deletion only if they have posted no messages and
  114.      uploaded or downloaded no files. This check eliminates lots of chaff
  115.      from your UserLog from users who will probably never call back. LOM
  116.      comes withthis option preset for 60 days.
  117.  
  118. In addition to these options, you can create a text file called “Bad User
  119. Names” (no quotes) at the same level as Second Sight. Format for this file is
  120. from 1 to 50 capitalized names up to 15 characters in length, one name per
  121. line. A sample file follows (minus some obvious obscenities):
  122.  
  123. BOMBER
  124. CRASHER
  125. DEATH
  126. GOD
  127. HACKER
  128. MANIAC
  129. SATAN
  130. TERMINATOR
  131.  
  132. If a user signs on with one of these as either first name or last name,
  133. the user will be purged during backup. If you don’t create such a list, no
  134. one will be checked.
  135.  
  136. I created the Change level command and the scan for bad user names to
  137. allow me to implement automatic overnight validation for those who
  138. complete the survey. In addition to unpleasant names, you can also include
  139. names of any twits who recurrently plague your board.
  140.  
  141. Sort UserLog
  142. ------------
  143. Enable this if you want to sort your UserLog by level and date of last
  144. call. Sorting by level lets currently active users log on more quickly,
  145. and lets you easily find inactive users (look at the bottom of the lists
  146. at each level).
  147.  
  148. Zero user minutes
  149. -----------------
  150. Enable this if you want to reset everyone’s “Minutes Used in Last Call.”
  151. This feature lets everyone get a fresh start every day for boards which
  152. limit the number of calls for a certain number of hours. Normally, if you
  153. use a 12-hour limit and some poor soul calls 11 hours and 30 minutes after
  154. his or her previous call, the user is denied access for *another* 12
  155. hours. Log-O-Matic can give everyone a new beginning at midnight (or
  156. whenever you run it).
  157.  
  158. Reset CallerLog
  159. ---------------
  160. Copies all entries in the CallerLog prior to today’s date to the end of a
  161. file called CallerLog.Arch, which is created, if necessary. The CallerLog
  162. is cleared of all calls prior to today’s date.
  163.  
  164. Monthly CallerLog.Arch backup
  165. -----------------------------
  166. Renames CallerLog.Arch to a file called CallerLog mm/yy (where mm is the
  167. two-digit previous month and yy is the two-digit current year [the previous
  168. year if the archive is dated December]) and creates a new empty file called
  169. CallerLog.Arch.
  170.  
  171. Reset Tabby Log
  172. ---------------
  173. Copies all entries in the Tabby Log prior to today’s date to the end of a
  174. file called Tabby Log.Arch, which is created, if necessary. The Tabby Log
  175. is cleared of all calls prior to today’s date.
  176.  
  177. Limit Tabby Log.Arch to [you select] K
  178. --------------------------------------
  179. Enable this to control the maximum size of the Tabby Log.Arch file.
  180. Whatever number you enter in the edit text field is multiplied by 1 K,
  181. which is 1024 bytes. If this is enabled and the current size of the Tabby
  182. Log.Arch file exceeds the limit you’ve set, Log-O-Matic makes a copy of the
  183. Tabby Log.Arch file minus enough of the oldest portion to bring the file
  184. down to the proper size, then deletes the original and renames the copy as
  185. Tabby Log.Arch.
  186.  
  187.  
  188. The functions performed by LOM all grow out of my needs as a sysop. I use
  189. every one of LOM’s options on Glassell Park, and I figure this little
  190. contraption saves me many hours of maintenance every month. Some of its
  191. functions were introduced in Archie, but Archie requires a human pilot and LOM
  192. doe not. No other single utility -- none that I’ve seen, anyway -- combines
  193. the range of options of LOM. I hope you find it as useful as I do.
  194.  
  195. Log-O-Matic was written in LightSpeed Pascal. It is free for registered Archie
  196. & mehitabel users, but may not otherwise be distributed.
  197.  
  198. -- Pete Johnson
  199.  
  200.    Glassell Park BBS  (Fido Node 102/863)
  201.    213-254-4133
  202.    Post Office Box 65074
  203.    Los Angeles, CA 90065
  204.  
  205.    November 10, 1990
  206.  
  207. --------------------------------------------------------------------------
  208.  
  209. Change History:
  210.  
  211. Version 1.1 runs correctly with other launch.next events under MultiFinder.
  212.  
  213. Version 1.2 adds automatic adjustment of user levels and screening for bad
  214. names.
  215.  
  216. Version 1.3 adds option to limit the size of the Tabby Log.Arch file.
  217.  
  218. Version 1.4 adds option to back up the CallerLog.Arch file once a month to a
  219. file called CallerLog mm/yy (where mm is a two-digit month and yy is a
  220. two-digit year).
  221.  
  222. Version 1.5 adds option to delete users who haven’t called in a specified
  223. number of days.
  224.  
  225. Version 1.51 is a small fix -- the archived CallerLog mm/yy document from
  226. version 1.4 is dated with the previous month (and previous year when
  227. appropriate) rather than the current month.
  228.  
  229. Version 1.52 adds option to delete inactive callers at or below a given access
  230. level.
  231.  
  232. Version 1.6 adds option to keep log of deleted users.
  233.  
  234. Version 1.61 adds calling from and password info to log of deleted callers and
  235. cleans up a few weird bits of code..
  236.  
  237. Version 1.7 allows you to delete one-time callers who haven’t called for a
  238. while, reorganizes the dialog displays and cleans up yet more few weird bits
  239. of code..
  240.  
  241. Version 1.71 and 1.72 are small fixes to the Configuration dialog and minor code cleanup.
  242.  
  243. --------------------------------------------------------------------------
  244.